home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 111 / wxymodem.doc < prev    next >
Text File  |  1987-09-20  |  9KB  |  196 lines
  1.  
  2. Copyright (c) 1987 by Thomas E. Zerucha.  These programs may be distributed
  3. freely as long as no charge is made except for the costs incurred in
  4. transcription if any.  These programs are being released as SHAREWARE, so
  5. you can try them before you decide if they are worth it.  Any suggestions
  6. on improvements would be appreciated (money talks louder).
  7.  
  8. ===========================================================================
  9.  
  10. SERINI.PRG
  11.  
  12.         Expands the I/O buffers to reduce CPU time waiting for the buffer
  13.         to have space enough - they are made larger than an entire YMODEM
  14.         block.  It also sets the port at 1200 Baud, 8N1 (8 bit word, no
  15.         parity, 1 stop bit), no control (no XON/XOFF).  The expansion also
  16.         makes transfer more reliable in case of delays due to other tasks.
  17.         For the auto folder.
  18.  
  19. ===========================================================================
  20.  
  21. Transfer program for shell useage (or as .ttp):
  22.  
  23.         WXYTR [-options] filename [more filenames]
  24.  
  25.         options (upper and lower case treated the same):
  26.                 -T   Transmit - send file to host
  27.                 -R   Receive - receive file from host
  28.  
  29.                 Transmit Protocol Extensions
  30.                 -B   Use Batch Mode (if one file specified)
  31.                 -K   Use 1K blocks only (Forem ST Ymodem)
  32.                 -Y   Use normal Ymodem - mix blocks at end
  33.                 Transmit Xmodem Modify
  34.                 -C   Force CRC regardless of init char
  35.                 -S   Force checksum regardless of init char
  36.                 -A   Accelerate over Packet Switched Networks (PC Pursuit)
  37.                 -3   Accelerate at 300 baud
  38.                 Receive Extensions
  39.                 -A   Accelerate - assume no errors, cancel if one occurs
  40.                 -W   WXmodem transfer (attempt)
  41.                 -B   Batch mode, no file name specified
  42.                 -S   Force checksum mode - don't try sending C to use CRC
  43.                 -O   Overwrite existing files
  44.                 -1   Single file only (reject batch)
  45.                 Other (both)
  46.                 -D   Show transfer progress (debug)
  47.  
  48.                 although A, B, and S are the same and are for similar
  49.                 functions, they do not affect the program identically.
  50.  
  51.         Transmit default is XMODEM with NAK/'C' setting checksum/CRC
  52.         will upgrade to WX if receiver requests WXmodem transfers,
  53.         but this will disable Ymodem (1K blocks, either -y or -k).
  54.  
  55.         Receive Mode, X or Y modem, and CRC or Checksum, and Batch or
  56.         single are automatically determined from the received character
  57.         stream. If W is specified, Wxmodem will be tried before CRC.
  58.  
  59.         filename - not required if batch receiveing, otherwise file to send
  60.         or receive, for send multiple files force Batch Mode.  A specified
  61.         receive file that is overridden by batch will not be created.
  62.  
  63.         For transmission:
  64.         Only one protocol extension is allowed (either to WX, Y or Y1K).
  65.         Acceleration only helps standard Xmodem, Do not use with extensions.
  66.         Force CRC/Checksum will work with Y, Y1K modem but is not recommend.
  67.         Force CRC/Checksum will NOT work with WX.
  68.         Batch mode (send) will NOT default to Ymodem - you must add -Y or -K.
  69.         Batch mode is NOT part of the WXmodem spec.
  70.  
  71.         Debug can be used any time.  A + will be printed for each ACKed
  72.         block, a - for NAKs, # for wrong block numbers, and filenames.
  73.  
  74.         The extensions which are simple supersets (true Ymodem) or use
  75.         characters (W,C,NAK) to determine protocol should back down to
  76.         simpler protocols properly, but THIS IS NOT GUARANTEED to work
  77.         with everything - it is best if you make sure the other end
  78.         will support the extension and is in that mode before extending
  79.         this end.  (Most problems come from the fact that each extension
  80.         backs down or detects subsets differently).
  81.  
  82.         If you are having many problems, try XModem forcing checksum, then
  83.         forcing CRC - some implementations accept the C but send checksum
  84.         instead of CRC, or vice versa - especially 8 bit Atari's.
  85.  
  86.         -K is used when uploading to a Forem ST system which does not accept
  87.         mixed X and Y Modem blocks according to the full specification.
  88.  
  89. This program will execute in background under MT C Shell or RTX and are
  90. optimized for this use.  Disk I/O is done when Character I/O is not critical.
  91. In this useage WXmodem receive might not run at full speed, and the packet
  92. accelerator will not time precisely enough - this is only during background
  93. with other active processes using CPU time.
  94.  
  95. Executing SERINI.PRG is recommended in either useage.
  96.  
  97. The only messages printed are for completion or fatal errors.
  98.  
  99. The program uses the Iorec Xbios function and may not work if the serial
  100. port is multiplexed - This is accessed to reject characters as noise
  101. coming in before the transmission is complete.
  102.  
  103. Try to use YModem Batch if possible since the length of the file will be
  104. copied exactly, instead of the nearest 1K or 128 bytes.
  105.  
  106. There might be a problem if these are run in the background, if the ampersand
  107. is connected with the last parameter - that parameter might not be copied,
  108. use:
  109.         WXYTR UP.ARC &
  110. instead of
  111.         WXYTR UP.ARC&
  112. under MT C Shell (and remember to disable tta1:)
  113.  
  114. ---------------------------------------------------------------------------
  115. WXYMODEM DESK ACCESSORY
  116.  
  117. 1. click on send if you want to send, or recieve if you want to recieve.
  118.  
  119. if sending...
  120. 2. click on the variant, Xmodem, Ymodem, Ymodem 1K (for Forem type systems),
  121.    or Accelerate.  WXmodem will automatically be detected from Xmodem.
  122. 3. if your reciever is out of spec, and requires either CRC or Checksum
  123.    click on the Force Option. (some Atari 8 bit).
  124. 4. if you are sending many files, or one in batch, click batch, otherwise
  125.    click OK.  If you wish to abort, click cancel.
  126. 5. a File Selector box will appear.  Click on each file you want - and click
  127.    on OK,  If sending batch, click on OK for each file, then on cancel to
  128.    start the batch send.
  129. 6. the file(s) will be sent - the progress will appear in a dialog box with
  130.    alert boxes upon completion.
  131.  
  132. if receiving...
  133. 2. click on WXmodem if you desire this protocol.
  134. 3. if using X/Y modem, click on "quick & dirty" if you are downloading small
  135.    files on a reliable line - it will send the ack early, but will cancel
  136.    the transfer if even one bad block is found.
  137. 4. Click on Force Checksum if you don't want CRC to be tried (for some out
  138.    of spec programs).  Click overwrite if you wish recieved files to
  139.    replace existing files if the filenames are the same.  (Some Atari 8 bit)
  140. 5. Click Batch for batch transfers, or OK - a batch transfer will force batch
  141.    mode in either case.
  142. 6. A File selector box will appear.  Select the directory for the files to
  143.    go into, and the name the file should take if it is not a batch transfer
  144.    (a default name if Batch is not working from the senders end).
  145. 7. A dialog box will monitor the progress, with alert boxes when done or
  146.    aborted.
  147.  
  148. Approximate mapping of command line options:
  149.  
  150.         -t              -r
  151.  
  152.         (none)          (none)
  153.         -y              -w
  154.         -k
  155.         -a              -a
  156.  
  157.         (none)          -o
  158.         -c
  159.         -s              -s
  160.  
  161.                 -b
  162.  
  163. NOTE: The ABORT button on the progress dialog functions only with the mouse.
  164.         Move the mouse into the box and click.  Hold the button down - it
  165.         may take several seconds to be recognized.
  166.  
  167. ---------------------------------------------------------------------------
  168. Tips on PC Pursuit and other notes:
  169.  
  170. 1. use SET? 1:0,7:8 to disable the <cr>@<cr> from dumping you to Telenet if
  171. the string happens to be in a file.  The 7:8 will enable the Break condition
  172. to get back to Telenet.
  173.  
  174. 2. Sometimes Telenet is too sensitive about Break conditions, 7:0 will fix
  175. that, but you will not be able to get back without hanging up.  Using two
  176. stop bits also seems to work, but slows the speed a little.  Xmodem, and
  177. Accelerated Xmodem don't seem to be affected, only Ymodem and WXmodem, and
  178. only on uploads.
  179.  
  180. 3. Redial a really noisy line.  These routines are good, but not perfect.
  181.  
  182. 4. This version of WXmodem will work in Batch mode, but the receiving end
  183. must specify WX, and maybe batch, and the sender batch.
  184.  
  185. 5. If you have many interrupt programs running, stealing CPU time, characters
  186. may be missed resulting in more NAKs.  If you are having a lot of problems,
  187. check your accessories and auto folder programs.
  188.  
  189. 6. Make sure you have enough space on the disk - I don't check for that
  190. (in this version).
  191.  
  192. ===========================================================================
  193. Micro RTX and MT C Shell are trademarks of Beckemeyer Development Tools.
  194. PC Pursuit is a trademark of Telenet, a US Sprint company.
  195. Portions of this program copyright (c) 1984, Mark Williams Co.
  196.